home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / comms / internet / html-related / hsc / src_docs / bugs.hsc < prev    next >
Text File  |  1996-09-30  |  4KB  |  89 lines
  1. <WEBPAGE chapter="hsc - " title="Bugs, Problems and Limitations"
  2.     PREV="source.html"
  3.     NEXT="future.html"
  4.     QTEXT=("So we keep putting our trust in things that rust<BR>"
  5.           +"And then we feel the pain of loss")
  6.     QAUTHOR='James, "Stripmining"'>
  7.  
  8. <H2>Known bugs</H2>
  9.  
  10. The problems below should be fixed.. sometimes.
  11. <UL>
  12. <LI>For missing end-tags, the position of the last occurence of the
  13.     start-tag with the same name is reported as correspondig 
  14.     start-tag.
  15. <LI>I'm still not sure, if <CODE>GETSIZE</CODE> for GIF89a can handle
  16.     everything correct - but hopefully it does. I've never seen such
  17.     an idiotic image-format before
  18. <LI>I'm still not sure, if <CODE>GETSIZE</CODE> for JFIF/JPEG can handle
  19.     everything correct - but hopefully it does. I've really never seen
  20.     such an idiotic, braindead, ill-minded and chaoticly structured 
  21.     image-format before.
  22. </UL>
  23.  
  24. <H2>Known problems (to be fixed)</H2>
  25.  
  26. The problems below are no real bugs and should be fixed.. sometimes.
  27. <UL>
  28. <LI>Most NEXT and PREV buttons of the  docs don't fit; I just wanted to
  29.     show how to create a navigation bar, but I'm too lazy to maintain it
  30.     while the structure of the documention isn't fixed.
  31. <LI>Some parts of the docs still need some improvement (like the chapter
  32.     about messages)
  33. <LI>As I know myself, these documents still contain loads of typos and
  34.     `strange english'..
  35. </UL>
  36.  
  37. <H2>Known problems</H2>
  38.  
  39. The problems described below probably won't ever be fixed.
  40. <UL>
  41. <LI>URI checking is performed via trying to open a file. As AmigaOS
  42.     is case-insensitive dealing with filenames, problems might
  43.     occure when copying the html-object-tree to a case-sensitive
  44.     filesystem. I recommend to rebuild the whole project at the
  45.     target system.
  46. <LI>If you specify a <TG>BASE HREF=".."</TG>, <hsc> is unable to
  47.     find out how the base is related to the destination-directory
  48.     and will treat all local URIs like external ones; Absolute URIs
  49.     aren't possible with a base-URI set, of course.
  50. <LI>For projects larger 500 documents, scanning the project-file on
  51.     every run takes a awful lot of time; due the lack of any portable
  52.     concept of keepind data resident after a program exits, there is
  53.     no workaround for this (same problem like with <hsc.prefs>); you
  54.     will have to get rid of the project-file and <hscdepp> for such
  55.     projects.
  56. <LI>The obsolete tags <TG>LISTING</TG> and <TG>XMP</TG> might not be
  57.     treated correctly, as the behavior of these two seems so be not
  58.     very strickly definded. You should avoid them anyway and use
  59.     <TG>PRE</TG> or <TG>$source</TG> instead.
  60. <LI><hsc> doesn't care much about filenames and their limitations; 
  61.     if, for example, a filename gets too long, it depends on 
  62.     <CODE>fopen()</CODE> of your compiler whether an error is reported 
  63.     or the filename
  64.     is truncated. If you insist on filenames containig 46587643 
  65.     characters, <hsc> can cope with it - but your OS probably won't.
  66. <LI>Out-of-memory can cause small memory-leaks. This is because <hsc>
  67.     uses a special <CODE>malloc()</CODE>-function
  68.     which just displays an error message and quits using 
  69.     <CODE>exit()</CODE>. As <hsc> keeps track of all allocated resources,
  70.     it will release everything that could be fully initialised and made
  71.     it into its supposed resource-list. For out-of-memories during
  72.     partially initialising complex structures, this failes and can
  73.     cause memory-leaks (normally approx. 100-500 bytes). Usually, these
  74.     are handled by your OS or, as for AmigaOS, by the 
  75.     <CODE>malloc()</CODE>-function of the run-time-library, so you
  76.     shouldn't bother too much about that. Blame K&R for their braindamaged
  77.     memory-managment concepts.
  78. </UL>
  79.  
  80. <H2>Limitations</H2>
  81.  
  82. <hsc> is fully dynamic and it's input size, numer of syntax-elements
  83. and etc. is only limited by memory and disk-space. Only some less important
  84. status messages are created in classic, braindead zero-terminated 
  85. C-character-arrays and are truncated if they become too long. Problems
  86. might occure if data leave 32-bit address-space.
  87.  
  88. </WEBPAGE>
  89.